home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / ifconfig < prev    next >
Encoding:
Text File  |  1995-08-31  |  9.4 KB  |  235 lines
  1.  
  2. ifconfig [<subcommand>]
  3.  
  4.      If a valid subcommand is given, it will be executed (see below).
  5. When no subcommand is given, display a list of interfaces, with a
  6. short status for each.  See the 'ifconfig <iface>' command for a
  7. description of the display.
  8.  
  9.      ALL ax25 and MOST tcp parameters are now configurable per
  10. interface.  The 'ax25 <cmd>' commands set the system default values
  11. and the 'ifconfig <iface> ax25 <command>' commands set or show the
  12. interface specific value(s).  The 'tcp <cmd>' commands work in the
  13. same manner.
  14.  
  15.      As a result of this change, 'ifconfig' NO LONGER takes multiple
  16. commands on one line.  'ifconfig ln0 netmask ffffff00 broadcast
  17. 255.255.255.255' is invalid.  The command line must be separated into
  18. two commands as: 'ifconfig ln0 netmask ffffff00' and 'ifconfig ln0
  19. broadcast 255.255.255.255'
  20.  
  21.      
  22.  
  23.     ifconfig <iface> [<subcommands>]
  24.  
  25.      When only iface is given, the interface status is displayed.
  26.      
  27.      Interface status shows:
  28.      
  29.         IP addr - the ip address assigned to this interface
  30.         MTU     - the maximum transmission unit for this interface.
  31.         Link encap - the type of link protocol to send packets  with
  32.                   over this interface (AX.25, NETROM etc.)
  33.         Paclen  - if the interface is an AX.25 interface, this is the
  34.                   Paclen used for connections on this interface
  35.         flags   - interface flags, the sum of all the options set with
  36.                   the various commands. See below.
  37.  
  38.         netmask - the ip network mask. See elsewhere for a discussion.
  39.                   broadcast - the ip broadcast address on this interface.
  40.                   Used when doing arp, etc.
  41.         sent ip - the number of ip packets sent on the interface
  42.         sent tot- the total number of packets sent (i.e. ip, ax.25,
  43.                   etc.)
  44.         sent idle - the elapsed time this interface hasn't transmitted
  45.                   any data.
  46.         recv ip - the number of ip packets received on the interface
  47.         recv tot- the total number of packets received  (i.e. ip,
  48.                   ax.25, etc.)
  49.         recv idle- the elapsed time this interface hasn't received any
  50.                   data.
  51.         descr   - a description of the interface
  52.  
  53.      Interface flag values are the sums of the following options, and
  54.      can be set or unset (i.e. toggled) with the following commands
  55.      (See their individual descriptions for more)
  56.  
  57. command           value                  description of flag
  58. mode iface        DATAGRAM_MODE     0    /* Send datagrams in raw
  59.                                             link frames */
  60.                   CONNECT_MODE      1    /* Send datagrams in
  61.                                             connected mode */
  62. netrom interface  IS_NR_IFACE       2    /* Activated for netrom use */
  63.                   NR_VERBOSE        4    /* broadcast routes verbose */
  64. convers interface IS_CONV_IFACE     8    /* Activated for conference
  65.                                             call access */
  66. ax25 bport        AX25_BEACON       16   /* Broadcast AX.25 beacons */
  67. mbox hide         HIDE_PORT         64   /* Don't show port in mbox
  68.                                             'P' command */
  69. ax25 digi         AX25_DIGI         128  /* Allow digipeating */
  70. arp eaves         ARP_EAVESDROP     256  /* Listen to ARP replies */
  71. arp poll          ARP_KEEPALIVE     512  /* Keep arp entries alive
  72.                                             after time-out */
  73. ax25 hport        LOG_AXHEARD       1024 /* Do ax.25 heard logging on
  74.                                             this interface */
  75. ip hport          LOG_IPHEARD       2048 /* Do IP heard logging on this
  76.                                             interface */
  77. mbox noax25       NO_AX25           4096 /* No ax.25 mbox connections on
  78.                                             this interface */
  79. mbox bbsonly      BBS_ONLY          8192 /* BBSes only on this iface */
  80. mbox usersonly    USERS_ONLY       16384 /* Users only on this iface */
  81. mbox sysoponly    SYSOP_ONLY       32768 /* Sysops only on this iface */
  82.  
  83.  
  84.     ifconfig <iface> ax25 [<subcommand>]
  85.  
  86.      Sets the value for 'subcommand' per description in the ax25
  87.      commands.  'ifconfig <iface> ax25' by itself displays the
  88.      following list of parameters and their values:
  89.      
  90.           bbscall
  91.           bctext
  92.           blimit
  93.           cdigi
  94.           irtt
  95.           maxframe
  96.           maxwait
  97.           paclen
  98.           pthresh
  99.           retry
  100.           timertype
  101.           t2
  102.           t3
  103.           t4
  104.           version
  105.           window
  106.  
  107.     ifconfig <iface> broadcast <addr>
  108.  
  109.      Set the ip broadcast address of interface <iface> to <addr>.
  110.      
  111.  
  112.     ifconfig <iface> cdigi <call>
  113.  
  114.      Set the 'crossband digipeater only' callsign.  If this call is
  115.      set, digipeating works independently from the 'ax25 digipeat'
  116.      setting.  Connections cannot be made to the cdigi call!
  117.      
  118.     ifconfig <iface> description "descr"
  119.  
  120.      This command sets the interface description to the string
  121.      specified.  If no descr is supplied (i.e. ""), the current
  122.      description will be cleared.  The description is displayed with
  123.      the mailbox or nodeshell P command (if the interface wasn't
  124.      hidden from that display).  It is also shown in the ifconfig
  125.      command.
  126.      
  127.  
  128.     ifconfig <iface> encapsulation <mode>
  129.  
  130.      Sets the encapsulation for interface iface to slip or ax25. This
  131.      should never be needed, since it is automatically executed when
  132.      interfaces are attached.
  133.      
  134.  
  135.     ifconfig <iface> forward <iface-2>
  136.  
  137.      When a forward is defined, all output for interface <iface> is
  138.      redirected to <iface-2>.  To remove the forward, set <iface-2> to
  139.      <iface>.
  140.      
  141.  
  142.     ifconfig <iface> ipaddress <addr>
  143.  
  144.      Set the IP address to <addr> for this interface. Normally the ip
  145.      address is assigned from the system ip address when the interface
  146.      is first attached. However, it might be necessary to change it
  147.      when a system acts as a ip-gateway.
  148.      
  149.  
  150.     ifconfig <iface> linkaddress <linkaddr>
  151.      Set the hardware dependent address for this interface.  For AX.25
  152.      this is the callsign.  If you want to allow cross band
  153.      digipeating, give each port a different ax.25 call with this
  154.      command.
  155.      
  156.      
  157.     ifconfig <iface> mtu <num>
  158.  
  159.      Set the maximum transfer unit to <num> bytes.
  160.  
  161.      
  162.     ifconfig <iface> netmask <address>
  163.  
  164.      Set the sub-net mask for this interface.  The <address> takes the
  165.      form of  an IP  address  with 1's in the network and subnet parts
  166.      of the address, and 0's in the host part of the address.  Sample:
  167.      ifconfig  ec0  netmask  0xffffff00 for  a  class  C  network  (24
  168.      bits).  This is related to the 'broadcast' subcommand.  See also
  169.      the 'route' command.
  170.      
  171.  
  172.     ifconfig <iface> paclen <num>
  173.  
  174.      Set the AX.25 paclen for this interface. This is useful if you
  175.      want to use a value different from the default as set with the
  176.      'ax25 paclen' command; e.g., if you have a port with an HF link,
  177.      you might want to set it to 128.  You can also set it to greater
  178.      than 256 if you have a high speed port.  (This command only works
  179.      for interfaces that can carry AX.25 connections, i.e., it is not
  180.      for SLIP interfaces, etc.)
  181.      
  182.      NOTE1:  The AX.25 V2 specification specifies a MAXIMUM of 256 for
  183.      paclen. If you have a paclen > 256, you may run into problems
  184.      when interfacing to other non-NOS systems (in particular G8BPQ-
  185.      based systems.)
  186.      
  187.      NOTE2:  The value of paclen influences NETROM behavior if the
  188.      interface is activated for netrom with the 'netrom interface'
  189.      command!  If the paclen for this interface is smaller than any
  190.      other (netrom active) paclen, the netrom mtu value will be set to
  191.      this paclen - 20 !  This is to assure that you will not get
  192.      fragmentation at the ax.25 level when trying to send large data
  193.      packets over netrom connections.  AX.25 V2.1 fragmentation is
  194.      presently handled only by NOS and derived code as far as is
  195.      known.  Other systems, such as TheNet, BPQ, MSYS,  etc., may not
  196.      include proper handling of V2.1 fragmentation.
  197.      
  198.      What the preceding means is, if you have a VHF port with paclen
  199.      256, and an Hf port with paclen 128, and BOTH are active with
  200.      netrom, the netrom mtu will be 108 !
  201.  
  202.  
  203.     ifconfig <iface> rxecho <iface-2>
  204.  
  205.      When a rxecho interface is defined, all input from interface
  206.      <iface> is also copied (echoed) to <iface-2>.  To remove rxecho,
  207.      set <iface-2> to "off".  This feature requires that RXECHO be
  208.      defined at compile time.
  209.      
  210.  
  211.     ifconfig <iface> tcp [<command>]
  212.  
  213.      Sets or displays the 'tcp' command parameters for <iface>.
  214.      'ifconfig <iface> tcp' by itself displays the following list:
  215.      
  216.           blimit
  217.           irtt
  218.           maxwait
  219.           mss
  220.           retries
  221.           syndata
  222.           timertype
  223.           window
  224.           
  225.      OUTGOING tcp connections get the values for the interface on
  226.      which the initial sync packet ('connect request') is routed out.
  227.      INCOMING tcp connections get the values for the interface the
  228.      initial request arrives on.
  229.      
  230.      System default TCP parameters must be set PRIOR TO attaching
  231.      interfaces.  After attaching interfaces, use the 'ifconfig
  232.      <iface> tcp' commands to set the interface.
  233.      
  234.  
  235.